scheduler

What is scheduler?

The scheduler package is a lightweight coordination module that allows for scheduling work with different priorities. It is used by React internally for its own scheduling of updates, and it can be used in other contexts to manage tasks with various levels of urgency.

What are scheduler's main functionalities?

Immediate Priority Scheduling

Schedules a task to be performed with the highest priority, effectively running it as soon as possible.

import { unstable_scheduleCallback, unstable_ImmediatePriority } from 'scheduler';

unstable_scheduleCallback(unstable_ImmediatePriority, () => {
  console.log('Run this task immediately');
});

User Blocking Priority Scheduling

Schedules a task with a priority level that is high but not as immediate, suitable for tasks that must respond to user input, like input handlers.

import { unstable_scheduleCallback, unstable_UserBlockingPriority } from 'scheduler';

unstable_scheduleCallback(unstable_UserBlockingPriority, () => {
  console.log('Run this task with user-blocking priority');
});

Normal Priority Scheduling

Schedules a task with a normal priority, which is suitable for tasks that do not need to be run immediately or in response to direct user input.

import { unstable_scheduleCallback, unstable_NormalPriority } from 'scheduler';

unstable_scheduleCallback(unstable_NormalPriority, () => {
  console.log('Run this task with normal priority');
});

Idle Priority Scheduling

Schedules a task with the lowest priority, which will run when the browser is idle, suitable for background and low priority tasks.

import { unstable_scheduleCallback, unstable_IdlePriority } from 'scheduler';

unstable_scheduleCallback(unstable_IdlePriority, () => {
  console.log('Run this task when the browser is idle');
});

Other packages similar to scheduler

node-schedule

A cron-like and not-cron-like job scheduler for Node.js. It allows scheduling using cron syntax as well as more flexible date-based scheduling, unlike the scheduler package which is more about prioritizing task execution.

agenda

A light and flexible job scheduling library for Node.js that uses MongoDB for persisting job data. It's more feature-rich for job scheduling with persistence, compared to the in-memory scheduling approach of the scheduler package.

bull

A Redis-based queue system for handling distributed jobs and messages in Node.js. It's more suitable for distributed systems and offers features like rate limiting, which are not present in the scheduler package.

later

A library for describing recurring schedules and calculating their occurrences. It provides a more human-readable way of scheduling tasks, unlike the scheduler package which focuses on task prioritization rather than recurrence patterns.

README

scheduler

This is a package for cooperative scheduling in a browser environment. It is currently used internally by React, but we plan to make it more generic.

The public API for this package is not yet finalized.

Thanks

The React team thanks Anton Podviaznikov for donating the scheduler package name.

Changelog

0.12.0 (October 28, 2014)

React Core

Breaking Changes

• key and ref moved off props object, now accessible on the element directly
• React is now BSD licensed with accompanying Patents grant
• Default prop resolution has moved to Element creation time instead of mount time, making them effectively static
• React.__internals is removed - it was exposed for DevTools which no longer needs access
• Composite Component functions can no longer be called directly - they must be wrapped with React.createFactory first. This is handled for you when using JSX.

New Features

• Spread operator ({...}) introduced to deprecate this.transferPropsTo
• Added support for more HTML attributes: acceptCharset, classID, manifest

Deprecations

• React.renderComponent --> React.render
• React.renderComponentToString --> React.renderToString
• React.renderComponentToStaticMarkup --> React.renderToStaticMarkup
• React.isValidComponent --> React.isValidElement
• React.PropTypes.component --> React.PropTypes.element
• React.PropTypes.renderable --> React.PropTypes.node
• DEPRECATED React.isValidClass
• DEPRECATED instance.transferPropsTo
• DEPRECATED Returning false from event handlers to preventDefault
• DEPRECATED Convenience Constructor usage as function, instead wrap with React.createFactory
• DEPRECATED use of key={null} to assign implicit keys

Bug Fixes

• Better handling of events and updates in nested results, fixing value restoration in "layered" controlled components
• Correctly treat event.getModifierState as case sensitive
• Improved normalization of event.charCode
• Better error stacks when involving autobound methods
• Removed DevTools message when the DevTools are installed
• Correctly detect required language features across browsers
• Fixed support for some HTML attributes:
  • list updates correctly now
  • scrollLeft, scrollTop removed, these should not be specified as props
• Improved error messages

React With Addons

New Features

• React.addons.batchedUpdates added to API for hooking into update cycle

Breaking Changes

• React.addons.update uses assign instead of copyProperties which does hasOwnProperty checks. Properties on prototypes will no longer be updated correctly.

Bug Fixes

• Fixed some issues with CSS Transitions

JSX

Breaking Changes

• Enforced convention: lower case tag names are always treated as HTML tags, upper case tag names are always treated as composite components
• JSX no longer transforms to simple function calls

New Features

• @jsx React.DOM no longer required
• spread ({...}) operator introduced to allow easier use of props

Bug Fixes

• JSXTransformer: Make sourcemaps an option when using APIs directly (eg, for react-rails)